home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / utilities / _customise / ssavers / _dimwit / _help next >
Encoding:
Text File  |  1991-04-21  |  7.8 KB  |  198 lines
  1.     *** Click FullScreen (Ŵ) in mode 12/15/20/21 ***
  2.  
  3.  
  4.   DimWit: A desk top screen saver
  5.   ===============================
  6.  
  7.     **************************************************************
  8.     *                                                            *
  9.     *                    DimWit                                  *
  10.     *                                                            *
  11.     *   This program, the source, obect and data files are       *
  12.     *             Copyright © Gordon Henderson                   *
  13.     *                                                            *
  14.     *  Permission is hereby granted to use, copy and distribute  *
  15.     *  this software, as long as this notice remains intact and  *
  16.     *          you pass on no less than what you received.       *
  17.     *                                                            *
  18.     * THIS SOFTWARE IS PROVIDED "AS IS"  WITHOUT WARRANTY OF ANY *
  19.     * KIND. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF *
  20.     *    THIS SOFTWARE IS WITH YOU. SHOULD THE PROGRAM PROVE     *
  21.     *    DEFECTIVE, YOU ASSUME THE COST OF ALL THE NECESSARY     *
  22.     *             SERVICING, REPAIR OR CORRECTION.               *
  23.     *                                                            *
  24.     **************************************************************
  25.  
  26.  
  27.   This little utility enables you to forget about screen burn-in if
  28.   you leave the Archimedies desktop unattended for a period of time.
  29.  
  30.   To use, simply double-click on the !DimWit icon. This will load
  31.   DimWit and place the DimWit icon on the icon bar.
  32.  
  33.   The desktop will be replaced by a series of moving patterns with a
  34.   Black backgound that will (help to) prevent any burn in.
  35.  
  36.   DimWit looks at the mouse and keyboard every second or so and if the
  37.   mouse has moved, or you are pressing any key, then it resets it's
  38.   time-out counter and goes back to sleep. It you havn't moved the
  39.   mouse, or pressed any key for the time-out period, it takes over and
  40.   saves your screen.
  41.  
  42.   You can manually force DimWit to activate by moving the mouse to the
  43.   Bottom Left of the screen. DimWit will take over in a second or two.
  44.  
  45.   DimWit comes supplied with 3 screen saver programs. It runs each of
  46.   these in turn for the time specified by the "Switch Time" in the
  47.   menu. (See below). You can force DimWit to activate the next screen
  48.   saver program by pressing the "Action" Key.
  49.  
  50.   You can write your own screen saver programs and incorporate them
  51.   into DimWit. See below for more details.
  52.  
  53.   DimWit only functions when the desktop is active. If you press f12,
  54.   or run a program that isn't desktop friendly, then DimWit will be
  55.   unable to save the screen.
  56.  
  57.   Pressing any key (except the Action, Break or Reset keys!), or
  58.   moving the mouse will (almost) instantly restore the desktop screen
  59.   and it's contents. If you wake up DimWit by pressing a key, that key
  60.   will be stored and typed once DimWit has restored the screen! (so if
  61.   the last thing you were doing was editing, the key will be inserted
  62.   into the edit buffer!)
  63.  
  64.  
  65.   Icon menu options
  66.   =================
  67.  
  68.     Info: (Pull Right)
  69.       Display program information block with version and creation date.
  70.  
  71.     Hide icon:
  72.       This causes the icon to be removed from the display. (DimWit
  73.       will still be active, you just won't be able to use the menu to
  74.       set timeout options, etc.).
  75.  
  76.       I don't really beleive that a utility like this should have an
  77.       icon at all, but once you have set your own preferenctes for the
  78.       time-out and switch time you can remove the icon from the
  79.       display. You can bring the icon back at any time by pressing the
  80.       "Action" Key. (You may need to keep it pressed for a second or
  81.       two). You can start DimWit without the icon if desired, see the
  82.       !Run file for details.
  83.  
  84.     Manual Dim:
  85.       Clicking this toggles between automatic screen save or manual
  86.       screen save. In manual mode, (the icon menu entry will be
  87.       ticked), DimWit will only activate when you move the mouse to
  88.       the Bottom Left of the screen. You may want to set this when
  89.       running a compute-intensive program that is desktop friendly.
  90.       (Eg. QRT, this lets you use the desktop while doing it's
  91.       processing, but if you left it alone, DimWit would get in after
  92.       it's time-out time and stop it. (It would continue as if nothing
  93.       had happened when you woke up DimWit). If you were still using
  94.       the desktop, then this would not be a problem. (But have you
  95.       tried using the desktop when QRT is running ?)
  96.  
  97.     Delay Time: (Pull Right)
  98.       Pull right on this entry to give a new menu with the availiable
  99.       time-out times. The options available are 5, 10, 15, 20, 25 and
  100.       30 minutes. The currently selected time-out is ticked. These
  101.       options are stored in the "Config" file and will be reloaded the
  102.       next time you start DimWit.
  103.  
  104.     Switch Time: (Pull Right)
  105.       Pull Right on this entry to give a new menu with the time to
  106.       wait before switching to a different screen-saver program. The
  107.       options available are 1, 2, 5 and 10 minutes. The currently
  108.       selected time is ticked. These options are stored in the
  109.       "Config" file and will be reloaded the next time you start
  110.       DimWit.
  111.  
  112.     Quit:
  113.       Totally removes DimWit from memory.
  114.  
  115.  
  116.  
  117.   Adding a new DimWit saver program
  118.   =================================
  119.  
  120.     1. Examine the current DimWit programs in the directory
  121.            <DimWit$Dir>.DimWits
  122.        to see how it's done and read the guidelines below.
  123.  
  124.     2. Write and debug your program (Or download it fro a buletin
  125.        board if it's someone elses).
  126.  
  127.     3. Load the program "DimWit"
  128.  
  129.     4. Edit this program:
  130.  
  131.       * Insert a new LIBRARY instruction to load your code.
  132.  
  133.       * Add a line to call youe code initialisation routine. (If needed).
  134.  
  135.       * Edit the line that initialises "totalDimWits" (Add 1 to it).
  136.  
  137.       * Add a new line in the procedure PROC_launchNextDimWit to call
  138.         your code
  139.  
  140.     5. Test it
  141.  
  142.     6. Upload it (Your code only) to the bulletin board that you got
  143.        DimWit from and any other board that you know of that is DimWit
  144.        can be downloaded from. (Share and Enjoy!)
  145.  
  146.     7. Send me some email.
  147.  
  148.   Guidelines for writing new DimWit programs
  149.   ==========================================
  150.  
  151.   You shouldn't change screen mode. (You can probably get away with
  152.   it, but I'm not sure what would happen if you were in a small memory
  153.   mode in the desktop, then your saver changed to a mode that required
  154.   more memory and there wasn't enough memory for it ...)
  155.  
  156.   The global varable wimpMode% will be set to the mode that the wimp
  157.   was in when DimWit took over, so you can execute a
  158.  
  159.       MODE wimpMode%
  160.  
  161.   statement to re-initialise the current screen mode if you want to
  162.   muck about with the pallets, etc ...
  163.  
  164.   At well defined intervals in your code, you need to call the
  165.   function FN_wakeUp.  This returns TRUE or FALSE. When it returns
  166.   TRUE, this indicates that you should ENDPROC as quickly as possible
  167.   because the user (you!) have moved the mouse or typed something and
  168.   you want you use your machine again! (You don't need to clear the
  169.   screen or reset the mode as this is done by DimWit)
  170.  
  171.   If you want to prematurley terminate your saver (and let DimWit call
  172.   the next one in the sequence) then you need to set the global
  173.   variable
  174.  
  175.       returnToUser%
  176.  
  177.   to FALSE before executing your ENDPROC.
  178.  
  179.   Thats about it really, try not to make them too large or use massive
  180.   ammounts of store. you may have to adjust the WimpSlot instruction
  181.   in the !Run file if you do! (It's currently set to 64K and I think
  182.   this is more than enough memory to allocate to a screen saver!)
  183.  
  184.  
  185.   Comments, buggs and new DimWit savers can be sent to me,
  186.  
  187.     Gordon Henderson,
  188.     29 Cobourg Road,
  189.     Montpelier,
  190.     Bristol, England
  191.     BS6 5HT
  192.  
  193.     Arcade: gordon, user id #436
  194.  
  195.     eMail:  gordon@uk.co.meiko
  196.  
  197.   Enjoy!
  198.